home *** CD-ROM | disk | FTP | other *** search
/ Game Head 1996 March / Game Head March 96.iso / dos / pollux / hsterror.doc < prev    next >
Encoding:
Text File  |  1995-04-19  |  6.6 KB  |  169 lines
  1. Filename          HSTERROR.DOC
  2. Documentname      Host Errors v1.0
  3. Contents          Description of possible host errors during calculation.
  4. By                FP
  5. Date              22/1 95
  6.  
  7.  
  8. Introduction
  9. Whenever an error occurs during calculation, this error is reported on
  10. screen (allthough only for a few seconds unless hosted externally), and the
  11. host error number is written in the HSTERROR.LOG which is placed in the
  12. game directory. The log file is a simple textfile that can be view by typing
  13. the DOS-command TYPE HSTERROR.LOG or by using a textviewer like the DOS
  14. EDIT command.
  15.  
  16. There are a few types of host error commands. They occur during a specific
  17. time during the calculation.
  18.  
  19.  
  20. HOST file authentity errors.
  21. ----------------------------
  22.  
  23. Whenever the host accesses the harddisk to get information from a file, it
  24. checks the severel things to make sure that it is the right file it has its
  25. hands on. The GameID is construction from the time and date when the game
  26. was initialized, the versionnumber tells the host which recordlayout to use
  27. and also the turn number is checked to ensure that it is the right turnfile.
  28. Errors that occur because of these checks, are both sent to player and to
  29. the host, but the calculation is not stopped. If you want that you must make
  30. your own external checks before trying to host.
  31.  
  32.  
  33. Errortext sent to players
  34.  
  35. 1  Last turnfile was an old turnfile and could not be used.
  36. 2  Wrong game uploaded. Pollux cannot use another games data in this game!
  37. 3  Last turn your file was missing, and could not be calculated.
  38.  
  39.  
  40. Errortext sent to host
  41.  
  42. 1  Old turn x file from player x
  43. 2  Player x uploaded turn for other game
  44. 3  Missing player x's turn !
  45.  
  46.  
  47. HOST Loading player commands
  48. ----------------------------
  49.  
  50. When the hosts needs to know what the players have been doing the last
  51. round, it reads the PLAYERx.GUE file and executes the commands in this file.
  52. Using the document (GUECOMS.DOC coming soon..) it is actually possible to
  53. make your own userinterface. Any errors while executing these commands is
  54. reported in HSTERROR.LOG
  55.  
  56. The procedure that takes care of loading the commands for the host are also
  57. used when you have played your turn and afterwards wants to reenter and
  58. change something. This ensures that the data you have next time, is the
  59. exact same data the host will know.
  60.  
  61. There are no checking on record stability. If an unstability occurs, Pollux
  62. might die, for a while...
  63.  
  64. Oh, about the weird errorcode numbering, I have a system in there somewhere..
  65.  
  66. Error code  Reason
  67.    10       Planetnumber has not been initialized. This would be a bug in
  68.             the GUE file. You should play your turn again and try again.
  69.  
  70.    20..24   Same as 10.
  71.  
  72.    25       Either planetnumber has not been initialized or you could not
  73.             affort the price of the defenseposts you wanted to buy.
  74.  
  75.    26..27
  76.    30       Same as 10.
  77.  
  78.    31       Number of energytype or requested supply not within legal limits.
  79.  
  80.    32       Number of allocationtype or requested allocation not within
  81.             legal limits.
  82.  
  83.    33       Unknown tradeitem or requested trade support not within limits.
  84.  
  85.    40       Same as 10.
  86.    4001     Lifesupport problems. Not enough iron or supplies for the
  87.             requested life support.
  88.  
  89.    41       Planetnumber has not been initialized or unknown colonyitem.
  90.    4101     Not enough iron or supplies to build colonyitem. A Colonyitem
  91.             is fx the University, the Administration etc.
  92.  
  93.    42       Planetnumber has not been initialized or unknown system-
  94.             improvement.
  95.    4201     Not good enough science, not enough cash or not enough supplies.
  96.  
  97.    43       Same as 10.
  98.  
  99.    44       Planetnumber not initialized or AUTOChap value not within limits.
  100.  
  101.    60       Planet not owned by player and shipbuilding not possible, or
  102.             not enough cash to buy shiphulltype.
  103.    6001     Unknown weapontype, not enough cash to build the weapon or
  104.             not good enough sciencelevels.
  105.    6002     Ship cargobay not within limits.
  106.    6003     Unknown equipmenttype, not enough cash to build the equipment or
  107.             not good enough sciencelevels.
  108.  
  109.    61       Ship not owned by requesting player !
  110.  
  111.    63       Unknown weapontype, not enough cash to build the weapon or
  112.             not good enough sciencelevels.
  113.    6301     Not enough rawmaterials or not enough cash for weapon.
  114.  
  115.    64       Unknown equipmenttype, not enough cash to build the equipment or
  116.             not good enouh sciencelevels.
  117.    6401     Not enough rawmaterials or not enough cash for weapon.
  118.  
  119.    70       Player tried to give civil orders to a ship not owned by player.
  120.  
  121.    71       Player tried to give civil orders to a ship not owned by player.
  122.  
  123.    72       Player tried to load or dump waste on/from ship not owned by
  124.             player. Who are you playing with ?????
  125.    7201     Not enough room on ship for waste or not enough waste on planet.
  126.  
  127.    73       Player tried to load or dump waste on/from shipnot owned by
  128.             player. Tough guy!
  129.    7301     No room on ship, no ground forces available, enemy planet.
  130.  
  131.    74       No ship or ship not in orbit or ship not belonging to player or
  132.             unknown tradeitem or no massdriver present (needed for trade).
  133.    7401     Not enough cash to pay for tradinggoods or not enough room on
  134.             players tradingship.
  135.    7402     Lack of trading goods. Trying to load to many on ship. Error
  136.             can occur if two players try to load the same goods. No measures
  137.             have been taken for this event. The first ship to load will win
  138.             the trade.
  139.  
  140.    75       Player is trying to give away a ship that the players does not
  141.             own.
  142.  
  143.    76       Trying to put transmuting code on ship not owned by player or
  144.             the code itself is not within limits 49-56
  145.  
  146.    77       No ship was specified for bachyonship, must be gue file probs.
  147.  
  148.    78       Trying to repair ship that is not damage ?
  149.  
  150.    80       Trying to set shipcoordinates on ship not owned by player.
  151.  
  152.    81       Changing speed on ship not belonging to player or changing to
  153.             speed not yet invented by player !
  154.  
  155.    82       Putting cargo on ship not owned by player.
  156.    8201     Not enough room on ship, or not enough planetstock
  157.  
  158.    83       Shipnr out of range.
  159.  
  160.    100      Unknown sciencegroup or relative percent not within limits.
  161.  
  162.    130      Unknown leader or leaderposition.
  163.    13001    Not enough cash to bribe senator.
  164.  
  165.  
  166. Other errorcodes can occur if file is corrupt, these will also be written.
  167. Corrupt file errorcodes can generate errors with no meaning.
  168.  
  169.